﻿                           _________________________
                          | |__|__|  |__|__|__|__|  |
                          |__/O\__|__|________/O\|__|
                            
                            LOS SANTOS BUS SERVICE

                                    By WTLS




ABOUT THIS TXT:

This txt content:
- Description,
- Requirements,
- Known issues and their fixes,
- Installation,
- Uninstallation,
- How to use,
- Changelog,
- Credits,
- Notes.





DESCRIPTION:

In GTA 5, the majority of players travel by car, legally acquired or 
requisitioned from a passerby, or by taxi, even if this has a cost, but few are 
those who think of public transport. It must be said that only the tram is an 
option accessible in the game as a passenger: the only means of taking the bus 
are to hold the wheel ... or to climb on the roof. That didn't stop a helpful 
GTA 5 fan from making and posting on reddit a fictitious map of the bus services 
that could be set up in Los Santos!

This mod makes this fictitious map real and brings bus service to Los Santos!

Lines:
  - Metro Local (complete),
  - Metro Express (complete).

Features:
- Realistic liveries inspired from real Los Angeles buses one for Metro local 
  and one for Metro express,
- Worktimes and similar frequency of the bus map,
- Ability to skip to next stop or a specific stop (fast travel),
- Ability to carry bicycle,
- Toggle mod,
- Bus ads in liveries.





REQUIREMENTS:

- The two Scripthookvs,
- OpenIV,
- Bus Simulator V (with the default bus models),
- Gameconfig for Limitless Vehicles (choose stock or x0.5 or less traffic),
- Heap Adjuster,
- Packfile limit Adjuster.





KNOWN ISSUES AND FIXES:

You may get an error of NullReferenceException,
> reload mods and increase "TIMEBEFORESTART" in the ini file.

If no buses are spawned in the city and your computer time is from 10pm to 6am
that means that the script gets the time of the real world and not the time of
the game,
> disable "WORKTIMES" in the ini file to make buses work 24 hours.

Bus doesn't care about you and doesn't wait for you to get in,
> increase "WAITTIME" in the ini file.

Path issues like when the bus blocks somewhere or doesn't move,
> skip track by pressing context.
But you are not in the bus and you see it blocked and can't come to your bus stop,
> nothing you can do, just leave it.

Bus drivers drive like a maniac,
> welcome to Los Santos xD.





INSTALLATION:

Open OpenIV and click tools then package installer then choose the downloaded
"LSBS.oiv" OR right clic the downloaded "LSBS.oiv" and open with OpenIV, install in 
"Mods" folder.
Remove older ini file.
Put "LosSantosBusSerive2.dll" and "LosSantosBusSerive2.ini" in "scripts" folder.
Put "LosSantosBusService2" folder in "scripts" folder.







UNINSTALLATION:

Reinstall Bus Simulator V or uninstall it and remove "LosSantosBusSerive2.dll"
and "LosSantosBusSerive2.ini" and "ClientSpawner.dll" from "scripts" folder.





HOW TO USE:

You mod is enabled from the start.
You can toggle the mod using toggle mod key (F10 by default), you can change this key by 
changing TOGGLEMODKEY in the ini file.
Press your default enter/exit vehicle to enter bus when doors 
are opened, press many times if the player doesn't want to enter.
Press context to skip track if you want. If SKIPTOSPECIFICSTOP enabled, choose the stop
to skip to using phone keys left and right and select with phone select. If
SKIPTOSPECIFICSTOP disabled, you will skip to the next stop.
Use the bus map to know every bus line and check the game time.
To carry bike with you just exit it and enter bus normally.
If you want the buses to work 24 hours disable "WORKTIMES" in the ini file.
If you want the bike to be in the front of the bus disable "BIKEINSIDE" in
the ini file, enable it if you want the bike inside the bus.
Make your custom bus stop wait time in "WAITTIME" in half seconds.
"TIMEBEFORESTART" should be increased if you got script error.






CHANGELOG:

2.5:
- added ability to skip to a specific stop and not stop by stop.
- added ability to toggle the mod.

2.4.3:
- fixed animals enter bus,
- fixed bus floating after skiping to next stop,
- fixed player exit from rear door like other peds in terminal,
- other fixes.

2.4.2:
- fixed definitively FPS drop,
- fixed FPS disturbtion,
- fixed bus moving after skiping to thze next stop,
- improved client exiting bus.

2.4:
- added bus ads,
- completed all lines of Metro Local,
- added Metro Express with all its lines,
- added bus fare ($2 for Metro Local and $3 for Metro Express),
- added client exiting animation,
- added custom bus stop wait time,
- added a fix for NullReferenceException script error,
- improved bus stopping,
- fixed bus comes with no doors,
- fixed bus not coming in terminal,
- fixed path issues,
- other fixes.

2.2.1:
- extended bus waiting time to 7 seconds,
- fixed fps drop,
- fixed script error,
- fixed worktimes,
- fixed two buses spawned in the same area (bus flipped) (last one i promise),
- removed ClientsSpawner.dll
- other fixes.

2.2:
- added ability to carry a bicycle,
- fixed bus blocked and doesn't move,
- fixed two buses spawned in the same area (bus flipped),
- fixed clients don't enter bus,
- fixed one client stays on the bus in terminal station,
- fixed npc vehicles hit the bus from behind,
- fixed player enter bus (now just press one time),
- made skip track by pressing instead of pressing and holding context,
- added brake lights on when stopped at a bus stop,
- added custom bus speed in the ini file,
- other fixes.

2.1:
- added ability to skip to next stop (fast travel),
- fixed player doesn't want to enter,
- fixed same bus line spawn back to back,
- fixed bus blocked and doesn't move,
- fixed bus moving while in bus stop,
- fixed not all buses are spawned,
- fixed some path issues,
- added hint display,
- added enable/disable despawn unused buses,
- added custom enter key,
- added custom driving style,
- other fixes.

2.0.1 beta:
- added respawn bus if it has been exploded or driver is dead.

2.0 beta:
- first release.





CREDITS:

- Rockstar games,
- Alexander Blade,
- Crosire,
- I'm Not MentaL,
- Yoha,
- m101m102m103 (for reddit map),
- OpenIV team,
- t1a2l,
- sollaholla.




NOTES!:

You can't play Bus Simulator V if LSBS is installed.
Report path issues like when the bus blocks somewhere or doesn't move.
This mod has been made after a long work and lot of fixing of annoying things 
like NPC's stupidity.


                                        WTLS